Using the Set Recipient Table and Extract Files

Here are some hints on how to best use the set recipient table (SETRCPTB.DAT) and extract files:

Fewer triggers equals better performance. Each trigger is like a condition statement for the system to evaluate. The more conditions the system has to evaluate, the slower the processing cycle.

Use the master (M) and subordinate (S) flags to avoid repetition.

The set recipient table contains both form and section-level triggers to handle cases of conditional sections on forms. A section-level trigger can be used to trigger a form. This is beneficial in situations where a conditional image can trigger header and footer images. If, however, you use it improperly, you will add redundant conditional logic at both image and form level—which slows performance.

There are two flags (S and M) which you can use to control the evaluation of image level triggers and to maintain a hierarchy of form and image with respect to the inclusion of these entities into a form set. The S flag, called the subordinate flag, identifies the image as subordinate to the parent or master form level trigger. If the form is not triggered, all underlying image triggers can be ignored, which eliminates unnecessary processing. The subordinate flag also eliminates processing the same conditional logic over and over again since the logic is only performed once at the form level.

The master form flag (M) works in a similar manner but at the form level. When you use the M flag with a form level trigger, it does not matter whether the underlying image level triggers have an S flag—all will be treated as if they did. If the logic in a master form level trigger fails, the form does not trigger and all of the form’s image level triggers are ignored.

Limit your use of the RecipIf rule.

The RecipIf rule is just like the IF rule except it is used in the SETRCPTB.DAT file. The more conditions the system has to evaluate, the slower the processing cycle. Avoiding the RecipIf rule often depends on the structure of the extract file.

The ideal situation is to trigger a form or image based on one search criteria. If you want to trigger a form or image based on more than one search criteria, you may need to use the RecipIf rule. The more conditions you have, the more complicated the RecipIf rule will be. If the system has to look for a value in a given range of data instead of at an exact location, you have to add a long and complicated recipif. There is a price to pay for flexibility and it’s paid in performance.

For more information on the RecipIf rule, see Using the RecipIf Rule in the Documaker Administration Guide.

Structure the data in your extract file to be read in the order that it will be processed. This improves performance since the system will find the next piece of data to process faster.